/******************************************************************************* * Copyright (c) 2000, 2011 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ package org.eclipse.swt.widgets; import org.eclipse.swt.internal.*; import org.eclipse.swt.internal.motif.*; import org.eclipse.swt.*; import org.eclipse.swt.graphics.*; import org.eclipse.swt.events.*; /** * Instances of this class are selectable user interface * objects that allow the user to enter and modify text. * Text controls can be either single or multi-line. * When a text control is created with a border, the * operating system includes a platform specific inset * around the contents of the control. When created * without a border, an effort is made to remove the * inset such that the preferred size of the control * is the same size as the contents. * <p> * <dl> * <dt><b>Styles:</b></dt> * <dd>CENTER, ICON_CANCEL, ICON_SEARCH, LEFT, MULTI, PASSWORD, SEARCH, SINGLE, RIGHT, READ_ONLY, WRAP</dd> * <dt><b>Events:</b></dt> * <dd>DefaultSelection, Modify, Verify, OrientationChange</dd> * </dl> * <p> * Note: Only one of the styles MULTI and SINGLE may be specified, * and only one of the styles LEFT, CENTER, and RIGHT may be specified. * </p> * <p> * Note: The styles ICON_CANCEL and ICON_SEARCH are hints used in combination with SEARCH. * When the platform supports the hint, the text control shows these icons. When an icon * is selected, a default selection event is sent with the detail field set to one of * ICON_CANCEL or ICON_SEARCH. Normally, application code does not need to check the * detail. In the case of ICON_CANCEL, the text is cleared before the default selection * event is sent causing the application to search for an empty string. * </p> * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * * @see <a href="http://www.eclipse.org/swt/snippets/#text">Text snippets</a> * @see <a href="http://www.eclipse.org/swt/examples.php">SWT Example: ControlExample</a> * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * @noextend This class is not intended to be subclassed by clients. */ public class Text extends Scrollable { char echoCharacter; boolean ignoreChange; char [] hiddenText; String message; int drawCount; Color disabledColor; static final boolean IsGB18030; /** * The maximum number of characters that can be entered * into a text widget. * <p> * Note that this value is platform dependent, based upon * the native widget implementation. * </p> */ public static final int LIMIT; /** * The delimiter used by multi-line text widgets. When text * is queried and from the widget, it will be delimited using * this delimiter. */ public static final String DELIMITER; static final RGB MSG_FOREGROUND = new RGB (172, 168, 153); /* * These values can be different on different platforms. * Therefore they are not initialized in the declaration * to stop the compiler from inlining. */ static { LIMIT = 0x7FFFFFFF; DELIMITER = "\n"; IsGB18030 = Converter.defaultCodePage ().endsWith ("18030"); } /** * Constructs a new instance of this class given its parent * and a style value describing its behavior and appearance. * <p> * The style value is either one of the style constants defined in * class <code>SWT</code> which is applicable to instances of this * class, or must be built by <em>bitwise OR</em>'ing together * (that is, using the <code>int</code> "|" operator) two or more * of those <code>SWT</code> style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. * </p> * * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li> * <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li> * </ul> * * @see SWT#SINGLE * @see SWT#MULTI * @see SWT#READ_ONLY * @see SWT#WRAP * @see SWT#LEFT * @see SWT#RIGHT * @see SWT#CENTER * @see SWT#PASSWORD * @see SWT#SEARCH * @see SWT#ICON_SEARCH * @see SWT#ICON_CANCEL * @see Widget#checkSubclass * @see Widget#getStyle */ public Text (Composite parent, int style) { super (parent, checkStyle (style)); } /** * Adds the listener to the collection of listeners who will * be notified when the receiver's text is modified, by sending * it one of the messages defined in the <code>ModifyListener</code> * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see ModifyListener * @see #removeModifyListener */ public void addModifyListener (ModifyListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.Modify, typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when the control is selected by the user, by sending * it one of the messages defined in the <code>SelectionListener</code> * interface. * <p> * <code>widgetSelected</code> is not called for texts. * <code>widgetDefaultSelected</code> is typically called when ENTER is pressed in a single-line text, * or when ENTER is pressed in a search text. If the receiver has the <code>SWT.SEARCH | SWT.CANCEL</code> style * and the user cancels the search, the event object detail field contains the value <code>SWT.CANCEL</code>. * </p> * * @param listener the listener which should be notified when the control is selected by the user * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see SelectionListener * @see #removeSelectionListener * @see SelectionEvent */ public void addSelectionListener(SelectionListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener(listener); addListener(SWT.Selection,typedListener); addListener(SWT.DefaultSelection,typedListener); } /** * Adds the listener to the collection of listeners who will * be notified when the receiver's text is verified, by sending * it one of the messages defined in the <code>VerifyListener</code> * interface. * * @param listener the listener which should be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see VerifyListener * @see #removeVerifyListener */ public void addVerifyListener (VerifyListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener (listener); addListener (SWT.Verify, typedListener); } /** * Appends a string. * <p> * The new text is appended to the text at * the end of the widget. * </p> * * @param string the string to be appended * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the string is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void append (String string) { checkWidget(); if (string == null) error (SWT.ERROR_NULL_ARGUMENT); int position = OS.XmTextGetLastPosition (handle); byte [] buffer = Converter.wcsToMbcs (getCodePage (), string, true); boolean warnings = display.getWarnings (); display.setWarnings (false); OS.XmTextSetInsertionPosition (handle, position); OS.XmTextInsert (handle, position, buffer); position = OS.XmTextGetLastPosition (handle); OS.XmTextSetInsertionPosition (handle, position); display.setWarnings(warnings); } static int checkStyle (int style) { if ((style & SWT.SEARCH) != 0) { style |= SWT.SINGLE | SWT.BORDER; style &= ~SWT.PASSWORD; /* * NOTE: ICON_CANCEL has the same value as H_SCROLL and * ICON_SEARCH has the same value as V_SCROLL so they are * cleared because SWT.SINGLE is set. */ } if ((style & SWT.SINGLE) != 0 && (style & SWT.MULTI) != 0) { style &= ~SWT.MULTI; } style = checkBits (style, SWT.LEFT, SWT.CENTER, SWT.RIGHT, 0, 0, 0); if ((style & SWT.SINGLE) != 0) style &= ~(SWT.H_SCROLL | SWT.V_SCROLL | SWT.WRAP); if ((style & SWT.WRAP) != 0) { style |= SWT.MULTI; style &= ~SWT.H_SCROLL; } if ((style & SWT.MULTI) != 0) style &= ~SWT.PASSWORD; if ((style & (SWT.SINGLE | SWT.MULTI)) != 0) return style; if ((style & (SWT.H_SCROLL | SWT.V_SCROLL)) != 0) return style | SWT.MULTI; return style | SWT.SINGLE; } /** * Clears the selection. * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void clearSelection () { checkWidget(); int xDisplay = OS.XtDisplay (handle); if (xDisplay == 0) return; OS.XmTextClearSelection (handle, OS.XtLastTimestampProcessed (xDisplay)); } public Point computeSize (int wHint, int hHint, boolean changed) { checkWidget(); int width = wHint; int height = hHint; if (wHint == SWT.DEFAULT || hHint == SWT.DEFAULT) { int ptr = OS.XmTextGetString (handle); if (ptr == 0) return new Point (0, 0); int size = OS.strlen (ptr); if (size == 0) { if (hHint == SWT.DEFAULT) { if ((style & SWT.SINGLE) != 0) { height = getLineHeight (); } else { height = DEFAULT_HEIGHT; } } if (wHint == SWT.DEFAULT) { width = DEFAULT_WIDTH; } } else { byte [] buffer = new byte [size + 1]; OS.memmove (buffer, ptr, size); boolean wrap = (style & SWT.MULTI) != 0 && (style & SWT.WRAP) != 0; if (wrap && wHint != SWT.DEFAULT) { char[] chars = Converter.mbcsToWcs (getCodePage (), buffer); String text = new String (chars); String wrapped = display.wrapText (text, font, wHint); buffer = Converter.wcsToMbcs (getCodePage (), wrapped, true); } int xmString; if ((style & SWT.SINGLE) != 0) { xmString = OS.XmStringParseText ( buffer, 0, OS.XmFONTLIST_DEFAULT_TAG, OS.XmCHARSET_TEXT, null, 0, 0); } else { xmString = OS.XmStringGenerate ( buffer, OS.XmFONTLIST_DEFAULT_TAG, OS.XmCHARSET_TEXT, null); } int fontList = font.handle; if (hHint == SWT.DEFAULT) { if ((style & SWT.SINGLE) != 0) { height = getLineHeight (); } else { height = OS.XmStringHeight (fontList, xmString); } } if (wHint == SWT.DEFAULT) width = OS.XmStringWidth (fontList, xmString); OS.XmStringFree (xmString); } OS.XtFree (ptr); if ((style & SWT.SINGLE) != 0 && message.length () > 0) { if (wHint == SWT.DEFAULT) { byte [] buffer = Converter.wcsToMbcs (getCodePage (), message, true); int xmString = OS.XmStringGenerate ( buffer, OS.XmFONTLIST_DEFAULT_TAG, OS.XmCHARSET_TEXT, null); int fontList = font.handle; width = Math.max (width, OS.XmStringWidth (fontList, xmString)); OS.XmStringFree (xmString); } } } Rectangle trim = computeTrim (0, 0, width, height); return new Point (trim.width, trim.height); } public Rectangle computeTrim (int x, int y, int width, int height) { checkWidget(); if (horizontalBar != null) { int [] argList1 = {OS.XmNheight, 0}; OS.XtGetValues (horizontalBar.handle, argList1, argList1.length / 2); height += argList1 [1] + 4; } if (verticalBar != null) { int [] argList1 = {OS.XmNwidth, 0}; OS.XtGetValues (verticalBar.handle, argList1, argList1.length / 2); width += argList1 [1] + 4; } if ((style & SWT.MULTI) != 0) height+=4; XRectangle rect = new XRectangle (); OS.XmWidgetGetDisplayRect (handle, rect); x -= rect.x; y -= rect.y; width += rect.x * 2; height += rect.y * 2; int shadow = 0, highlight = 0; if ((style & SWT.MULTI) != 0 || (style & SWT.BORDER) != 0) { int [] argList = new int [] { OS.XmNshadowThickness, 0, OS.XmNhighlightThickness, 0, }; OS.XtGetValues (handle, argList, argList.length / 2); shadow = argList [1]; highlight = argList [3]; } x -= shadow + highlight; y -= shadow + highlight; width += (shadow + highlight) * 2; height += (shadow + highlight) * 2; return new Rectangle (x, y, width, height); } /** * Copies the selected text. * <p> * The current selection is copied to the clipboard. * </p> * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void copy () { checkWidget(); int xDisplay = OS.XtDisplay (handle); if (xDisplay == 0) return; OS.XmTextCopy (handle, OS.XtLastTimestampProcessed (xDisplay)); } void createHandle (int index) { int [] argList1 = { OS.XmNverifyBell, 0, OS.XmNeditMode, (style & SWT.SINGLE) != 0 ? OS.XmSINGLE_LINE_EDIT : OS.XmMULTI_LINE_EDIT, OS.XmNscrollHorizontal, (style & SWT.H_SCROLL) != 0 ? 1 : 0, OS.XmNscrollVertical, (style & SWT.V_SCROLL) != 0 ? 1 : 0, OS.XmNwordWrap, !IsGB18030 && (style & SWT.WRAP) != 0 ? 1: 0, OS.XmNeditable, (style & SWT.READ_ONLY) != 0 ? 0 : 1, OS.XmNcursorPositionVisible, (style & SWT.READ_ONLY) != 0 ? 0 : 1, // OS.XmNmarginWidth, 3, // OS.XmNmarginHeight, 1, OS.XmNancestorSensitive, 1, }; int parentHandle = parent.handle; if ((style & SWT.SINGLE) != 0) { handle = OS.XmCreateTextField (parentHandle, null, argList1, argList1.length / 2); if (handle == 0) error (SWT.ERROR_NO_HANDLES); int [] argList2 = new int [] {OS.XmNcursorPositionVisible, 0}; OS.XtSetValues (handle, argList2, argList2.length / 2); } else { handle = OS.XmCreateScrolledText (parentHandle, new byte [1], argList1, argList1.length / 2); if (handle == 0) error (SWT.ERROR_NO_HANDLES); scrolledHandle = OS.XtParent (handle); } if ((style & SWT.BORDER) == 0) { int [] argList3 = new int [] { /* * Bug in Motif. Setting the margin width to zero for * a single line text field causes the field to draw * garbage when the caret is placed at the start of * the widget. The fix is to not set the margin width. */ // OS.XmNmarginWidth, 0, OS.XmNmarginHeight, 0, OS.XmNshadowThickness, 0, }; OS.XtSetValues (handle, argList3, argList3.length / 2); } /* * Feature in Motif. The Text widget is created with a default * drop target. This is inconsistent with other platforms. * To be consistent, disable the default drop target. */ OS.XmDropSiteUnregister (handle); } ScrollBar createScrollBar (int type) { return createStandardBar (type); } void createWidget (int index) { super.createWidget (index); hiddenText = new char [0]; message = ""; if ((style & SWT.PASSWORD) != 0) setEchoChar ('*'); if ((style & SWT.SINGLE) != 0) { disabledColor = new Color (display, MSG_FOREGROUND); } } /** * Cuts the selected text. * <p> * The current selection is first copied to the * clipboard and then deleted from the widget. * </p> * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void cut () { checkWidget(); int xDisplay = OS.XtDisplay (handle); if (xDisplay == 0) return; OS.XmTextCut (handle, OS.XtLastTimestampProcessed (xDisplay)); } int defaultBackground () { return display.textBackground; } Font defaultFont () { return display.textFont; } int defaultForeground () { return display.textForeground; } boolean dragDetect (int x, int y, boolean filter, boolean [] consume) { if (filter) { int [] start = new int [1], end = new int [1]; OS.XmTextGetSelectionPosition (handle, start, end); if (start [0] != end [0]) { int pos = OS.XmTextXYToPos(handle, (short) x, (short) y); if (start [0] <= pos && pos < end [0]) { if (super.dragDetect (x, y, filter, consume)) { if (consume != null) consume [0] = true; return true; } } } return false; } return super.dragDetect (x, y, filter, consume); } /** * Returns the line number of the caret. * <p> * The line number of the caret is returned. * </p> * * @return the line number * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getCaretLineNumber () { checkWidget(); return getLineNumber (OS.XmTextGetInsertionPosition (handle)); } /** * Returns a point describing the receiver's location relative * to its parent (or its display if its parent is null). * <p> * The location of the caret is returned. * </p> * * @return a point, the location of the caret * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public Point getCaretLocation () { checkWidget(); int position; position = OS.XmTextGetInsertionPosition (handle); short [] x = new short [1], y = new short [1]; OS.XmTextPosToXY (handle, position, x, y); return new Point (x [0], y [0] - getFontAscent (font.handle)); } /** * Returns the character position of the caret. * <p> * Indexing is zero based. * </p> * * @return the position of the caret * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getCaretPosition () { checkWidget(); return OS.XmTextGetInsertionPosition (handle); } /** * Returns the number of characters. * * @return number of characters in the widget * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getCharCount () { checkWidget(); return OS.XmTextGetLastPosition (handle); } /** * Returns the double click enabled flag. * <p> * The double click flag enables or disables the * default action of the text widget when the user * double clicks. * </p> * * @return whether or not double click is enabled * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public boolean getDoubleClickEnabled () { checkWidget(); int [] argList = {OS.XmNselectionArrayCount, 0}; OS.XtGetValues (handle, argList, argList.length / 2); return argList [1] != 1; } /** * Returns the echo character. * <p> * The echo character is the character that is * displayed when the user enters text or the * text is changed by the programmer. * </p> * * @return the echo character * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see #setEchoChar */ public char getEchoChar () { checkWidget(); return echoCharacter; } /** * Returns the editable state. * * @return whether or not the receiver is editable * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public boolean getEditable () { checkWidget(); /* * Bug in MOTIF. For some reason, when XmTextGetEditable () is called * from inside an XmNvalueChangedCallback or XmNModifyVerifyCallback, * it always returns TRUE. Calls to XmTextGetEditable () outside of * these callbacks return the correct value. The fix is to query the * resource directly instead of using the convenience function. */ int [] argList = {OS.XmNeditable, 0}; OS.XtGetValues (handle, argList, argList.length / 2); return argList [1] != 0; } /** * Returns the number of lines. * * @return the number of lines in the widget * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getLineCount () { checkWidget(); if ((style & SWT.SINGLE) != 0) return 1; int lastChar = echoCharacter != '\0' ? hiddenText.length : OS.XmTextGetLastPosition (handle); return getLineNumber (lastChar) + 1; } /** * Returns the line delimiter. * * @return a string that is the line delimiter * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see #DELIMITER */ public String getLineDelimiter () { checkWidget(); return "\n"; } /** * Returns the height of a line. * * @return the height of a row of text * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getLineHeight () { checkWidget(); return getFontHeight (font.handle); } int getLineNumber (int position) { if (position == 0) return 0; int count = 0, start = 0, page = 1024; char [] buffer = new char [page + 1]; /* * Bug in Linux. For some reason, XmTextGetSubstringWcs () does * not copy wchar_t characters into the buffer. Instead, it * copies 4 bytes per character. This does not happen on other * platforms such as AIX. The fix is to call XmTextGetSubstring () * instead on Linux and rely on the fact that Metrolink Motif 1.2 * does not support multibyte locales. */ byte [] buffer1 = null; if (OS.IsLinux) buffer1 = new byte [page + 1]; int end = ((position + page - 1) / page) * page; while (start < end) { int length = page; if (start + page > position) length = position - start; if (echoCharacter != '\0') { System.arraycopy (hiddenText, start, buffer, 0, length); } else { if (OS.IsLinux) { OS.XmTextGetSubstring (handle, start, length, buffer1.length, buffer1); for (int i=0; i<length; i++) buffer [i] = (char) buffer1 [i]; } else { OS.XmTextGetSubstringWcs (handle, start, length, buffer.length, buffer); } } for (int i=0; i<length; i++) { if (buffer [i] == '\n') count++; } start += page; } return count; } /** * Returns the widget message. The message text is displayed * as a hint for the user, indicating the purpose of the field. * <p> * Typically this is used in conjunction with <code>SWT.SEARCH</code>. * </p> * * @return the widget message * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @since 3.3 */ public String getMessage () { checkWidget (); return message; } int getNavigationType () { /* * Bug in Motif. On Solaris only, the implementation * of XtGetValues for XmText does not check for a zero * pointer in the arg list and GP's. The fix is to * allocate and free memory for the arg list value. */ if ((style & SWT.SINGLE) != 0) { return super.getNavigationType (); } int ptr = OS.XtMalloc (4); if (ptr == 0) return OS.XmNONE; int [] argList = {OS.XmNnavigationType, ptr}; OS.XtGetValues (handle, argList, argList.length / 2); int [] buffer = new int [1]; OS.memmove (buffer, ptr, 4); OS.XtFree (ptr); return buffer [0]; } /** * Returns the orientation of the receiver, which will be one of the * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>. * * @return the orientation style * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @since 2.1.2 */ public int getOrientation () { checkWidget(); return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT); } /*public*/ int getPosition (Point point) { checkWidget (); if (point == null) error (SWT.ERROR_NULL_ARGUMENT); return OS.XmTextXYToPos(handle, (short) point.x, (short) point.y); } /** * Returns a <code>Point</code> whose x coordinate is the * character position representing the start of the selected * text, and whose y coordinate is the character position * representing the end of the selection. An "empty" selection * is indicated by the x and y coordinates having the same value. * <p> * Indexing is zero based. The range of a selection is from * 0..N where N is the number of characters in the widget. * </p> * * @return a point representing the selection start and end * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public Point getSelection () { checkWidget(); int [] start = new int [1], end = new int [1]; OS.XmTextGetSelectionPosition (handle, start, end); if (start [0] == end [0]) { start [0] = end [0] = OS.XmTextGetInsertionPosition (handle); } return new Point (start [0], end [0]); } /** * Returns the number of selected characters. * * @return the number of selected characters. * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getSelectionCount () { checkWidget(); int [] start = new int [1], end = new int [1]; OS.XmTextGetSelectionPosition (handle, start, end); return end [0] - start [0]; } /** * Gets the selected text, or an empty string if there is no current selection. * * @return the selected text * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public String getSelectionText () { checkWidget(); if (echoCharacter != '\0') { Point selection = getSelection (); return getText (selection.x, selection.y); } int ptr = OS.XmTextGetSelection (handle); if (ptr == 0) return ""; int length = OS.strlen (ptr); byte [] buffer = new byte [length]; OS.memmove (buffer, ptr, length); OS.XtFree (ptr); return new String (Converter.mbcsToWcs (getCodePage (), buffer)); } /** * Returns the number of tabs. * <p> * Tab stop spacing is specified in terms of the * space (' ') character. The width of a single * tab stop is the pixel width of the spaces. * </p> * * @return the number of tab characters * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getTabs () { checkWidget(); /* Tabs are not supported in MOTIF. */ return 8; } /** * Returns the widget text. * <p> * The text for a text widget is the characters in the widget, or * an empty string if this has never been set. * </p> * * @return the widget text * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public String getText () { return new String (getTextChars()); } /** * Returns a range of text. Returns an empty string if the * start of the range is greater than the end. * <p> * Indexing is zero based. The range of * a selection is from 0..N-1 where N is * the number of characters in the widget. * </p> * * @param start the start of the range * @param end the end of the range * @return the range of text * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public String getText (int start, int end) { checkWidget(); if (!(start <= end && 0 <= end)) return ""; boolean hasEcho = echoCharacter != '\0'; int length = hasEcho ? hiddenText.length : OS.XmTextGetLastPosition (handle); if (length == 0) return ""; end = Math.min (end, length - 1); if (start > end) return ""; start = Math.max (0, start); int numChars = end - start + 1; if (hasEcho) return new String(hiddenText, start, numChars); int bufLength = numChars * OS.MB_CUR_MAX () + 1; byte [] buffer = new byte [bufLength]; int code = OS.XmTextGetSubstring (handle, start, numChars, bufLength, buffer); switch (code) { case OS.XmCOPY_FAILED: case OS.XmCOPY_TRUNCATED: error (SWT.ERROR_CANNOT_GET_TEXT); } char [] unicode = Converter.mbcsToWcs (getCodePage (), buffer); return new String (unicode, 0, numChars); } /** * Returns the widget's text as a character array. * <p> * The text for a text widget is the characters in the widget, or * a zero-length array if this has never been set. * </p> * * @return a character array that contains the widget's text * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see #setTextChars(char[]) * * @since 3.7 */ public char [] getTextChars () { checkWidget(); if (echoCharacter != '\0') { char [] text = new char [hiddenText.length]; System.arraycopy(hiddenText, 0, text, 0, text.length); return text; } int ptr = OS.XmTextGetString (handle); if (ptr == 0) return new char [0]; int length = OS.strlen (ptr); byte [] buffer = new byte [length]; OS.memmove (buffer, ptr, length); OS.XtFree (ptr); return Converter.mbcsToWcs (getCodePage (), buffer); } /** * Returns the maximum number of characters that the receiver is capable of holding. * <p> * If this has not been changed by <code>setTextLimit()</code>, * it will be the constant <code>Text.LIMIT</code>. * </p> * * @return the text limit * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see #LIMIT */ public int getTextLimit () { checkWidget(); return OS.XmTextGetMaxLength (handle); } /** * Returns the zero-relative index of the line which is currently * at the top of the receiver. * <p> * This index can change when lines are scrolled or new lines are added or removed. * </p> * * @return the index of the top line * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getTopIndex () { checkWidget(); if ((style & SWT.SINGLE) != 0) return 0; if (scrolledHandle == 0) return 0; int [] argList1 = {OS.XmNverticalScrollBar, 0}; OS.XtGetValues (scrolledHandle, argList1, argList1.length / 2); if (argList1 [1] == 0) return 0; int [] argList2 = {OS.XmNvalue, 0}; OS.XtGetValues (argList1 [1], argList2, argList2.length / 2); return argList2 [1]; } /** * Returns the top pixel. * <p> * The top pixel is the pixel position of the line * that is currently at the top of the widget. On * some platforms, a text widget can be scrolled by * pixels instead of lines so that a partial line * is displayed at the top of the widget. * </p><p> * The top pixel changes when the widget is scrolled. * The top pixel does not include the widget trimming. * </p> * * @return the pixel position of the top line * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public int getTopPixel () { checkWidget(); return getTopIndex () * getLineHeight (); } boolean hasIMSupport() { return true; } void hookEvents () { super.hookEvents (); int windowProc = display.windowProc; OS.XtAddCallback (handle, OS.XmNactivateCallback, windowProc, ACTIVATE_CALLBACK); OS.XtAddCallback (handle, OS.XmNvalueChangedCallback, windowProc, VALUE_CHANGED_CALLBACK); OS.XtAddCallback (handle, OS.XmNmodifyVerifyCallback, windowProc, MODIFY_VERIFY_CALLBACK); } int inputContext () { /* Answer zero. The text widget uses the default MOTIF input context. */ return 0; } /** * Inserts a string. * <p> * The old selection is replaced with the new text. * </p> * * @param string the string * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the string is <code>null</code></li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void insert (String string) { checkWidget(); if (string == null) error (SWT.ERROR_NULL_ARGUMENT); int [] start = new int [1], end = new int [1]; OS.XmTextGetSelectionPosition (handle, start, end); if (start [0] == end [0]) { start [0] = end [0] = OS.XmTextGetInsertionPosition (handle); } byte [] buffer = Converter.wcsToMbcs (getCodePage (), string, true); boolean warnings = display.getWarnings (); display.setWarnings (false); OS.XmTextReplace (handle, start [0], end [0], buffer); int position = start [0] + Math.max (0, buffer.length - 1); OS.XmTextSetInsertionPosition (handle, position); display.setWarnings (warnings); } void overrideTranslations () { if ((style & SWT.SINGLE) != 0) { OS.XtOverrideTranslations (handle, display.tabTranslations); } } /** * Pastes text from clipboard. * <p> * The selected text is deleted from the widget * and new text inserted from the clipboard. * </p> * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void paste () { checkWidget(); boolean warnings = display.getWarnings (); display.setWarnings (false); /* * Bug in Motif. Despite the fact that the documentation * claims that XmText functions work for XmTextFields, when * a text field is passed to XmTextPaste, Motif segment faults. * The fix is to call XmTextFieldPaste instead. */ if ((style & SWT.SINGLE) != 0) { OS.XmTextFieldPaste (handle); } else { OS.XmTextPaste (handle); } display.setWarnings (warnings); } void releaseWidget () { super.releaseWidget (); hiddenText = null; message = null; if (disabledColor != null) disabledColor.dispose (); disabledColor = null; } /** * Removes the listener from the collection of listeners who will * be notified when the receiver's text is modified. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see ModifyListener * @see #addModifyListener */ public void removeModifyListener (ModifyListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.Modify, listener); } /** * Removes the listener from the collection of listeners who will * be notified when the control is selected by the user. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see SelectionListener * @see #addSelectionListener */ public void removeSelectionListener(SelectionListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.Selection, listener); eventTable.unhook(SWT.DefaultSelection,listener); } /** * Removes the listener from the collection of listeners who will * be notified when the control is verified. * * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see VerifyListener * @see #addVerifyListener */ public void removeVerifyListener (VerifyListener listener) { checkWidget(); if (listener == null) error (SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook (SWT.Verify, listener); } boolean sendIMKeyEvent (int type, XKeyEvent xEvent) { return super.sendIMKeyEvent (type, xEvent, handle); } /** * Selects all the text in the receiver. * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void selectAll () { checkWidget(); /* Clear the highlight before setting the selection. */ int position = OS.XmTextGetLastPosition (handle); // OS.XmTextSetHighlight (handle, 0, position, OS.XmHIGHLIGHT_NORMAL); /* * Bug in MOTIF. XmTextSetSelection () fails to set the * selection when the receiver is not realized. The fix * is to force the receiver to be realized by forcing the * shell to be realized. If the receiver is realized before * the shell, MOTIF fails to draw the text widget and issues * lots of X BadDrawable errors. */ if (!OS.XtIsRealized (handle)) getShell ().realizeWidget (); /* Set the selection. */ int xDisplay = OS.XtDisplay (handle); if (xDisplay == 0) return; boolean warnings = display.getWarnings (); display.setWarnings (false); OS.XmTextSetSelection (handle, 0, position, OS.XtLastTimestampProcessed (xDisplay)); /* Force the i-beam to follow the highlight/selection. */ OS.XmTextSetInsertionPosition (handle, 0); display.setWarnings (warnings); } boolean setBounds (int x, int y, int width, int height, boolean move, boolean resize) { /* * Bug in Motif. For some reason an Xm warning is * output whenever a Text widget's caret is beyond * the visible region during a resize. The fix is * to temporarily turn off warnings below. */ boolean warnings = display.getWarnings (); display.setWarnings (false); boolean changed = super.setBounds (x, y, width, height, move, resize); display.setWarnings(warnings); return changed; } /** * Sets the double click enabled flag. * <p> * The double click flag enables or disables the * default action of the text widget when the user * double clicks. * </p><p> * Note: This operation is a hint and is not supported on * platforms that do not have this concept. * </p> * * @param doubleClick the new double click flag * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setDoubleClickEnabled (boolean doubleClick) { checkWidget(); int [] argList = {OS.XmNselectionArrayCount, doubleClick ? 4 : 1}; OS.XtSetValues (handle, argList, argList.length / 2); } /** * Sets the echo character. * <p> * The echo character is the character that is * displayed when the user enters text or the * text is changed by the programmer. Setting * the echo character to '\0' clears the echo * character and redraws the original text. * If for any reason the echo character is invalid, * or if the platform does not allow modification * of the echo character, the default echo character * for the platform is used. * </p> * * @param echo the new echo character * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setEchoChar (char echo) { checkWidget(); if ((style & SWT.MULTI) != 0) return; if (echoCharacter == echo) return; char [] newText; if (echo == 0) { newText = hiddenText; hiddenText = new char [0]; } else { newText = hiddenText = getTextChars (); } echoCharacter = echo; Point selection = getSelection(); boolean oldValue = ignoreChange; ignoreChange = true; setTextChars(newText); setSelection(selection); ignoreChange = oldValue; } /** * Sets the editable state. * * @param editable the new editable state * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setEditable (boolean editable) { checkWidget(); OS.XmTextSetEditable (handle, editable); style &= ~SWT.READ_ONLY; if (!editable) style |= SWT.READ_ONLY; if ((style & SWT.MULTI) != 0) return; int [] argList = {OS.XmNcursorPositionVisible, editable && hasFocus () ? 1 : 0}; OS.XtSetValues (handle, argList, argList.length / 2); } /** * Sets the widget message. The message text is displayed * as a hint for the user, indicating the purpose of the field. * <p> * Typically this is used in conjunction with <code>SWT.SEARCH</code>. * </p> * * @param message the new message * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the message is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @since 3.3 */ public void setMessage (String message) { checkWidget (); if (message == null) error (SWT.ERROR_NULL_ARGUMENT); this.message = message; redrawHandle (0, 0, 0, 0, true, handle); } /** * Sets the orientation of the receiver, which must be one * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>. * <p> * Note: This operation is a hint and is not supported on * platforms that do not have this concept. * </p> * * @param orientation new orientation style * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @since 2.1.2 */ public void setOrientation (int orientation) { checkWidget(); } public void setRedraw (boolean redraw) { checkWidget(); if ((style & SWT.SINGLE) != 0) return; if (redraw) { if (--drawCount == 0) OS.XmTextEnableRedisplay(handle); } else { if (drawCount++ == 0) OS.XmTextDisableRedisplay(handle); } } /** * Sets the selection. * <p> * Indexing is zero based. The range of * a selection is from 0..N where N is * the number of characters in the widget. * </p><p> * Text selections are specified in terms of * caret positions. In a text widget that * contains N characters, there are N+1 caret * positions, ranging from 0..N. This differs * from other functions that address character * position such as getText () that use the * regular array indexing rules. * </p> * * @param start new caret position * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setSelection (int start) { checkWidget(); /* Clear the selection and highlight before moving the i-beam. */ int xDisplay = OS.XtDisplay (handle); if (xDisplay == 0) return; int position = OS.XmTextGetLastPosition (handle); int nStart = Math.min (Math.max (start, 0), position); boolean warnings = display.getWarnings (); display.setWarnings (false); // OS.XmTextSetHighlight (handle, 0, position, OS.XmHIGHLIGHT_NORMAL); OS.XmTextClearSelection (handle, OS.XtLastTimestampProcessed (xDisplay)); /* Set the i-beam position. */ OS.XmTextSetInsertionPosition (handle, nStart); display.setWarnings (warnings); } /** * Sets the selection to the range specified * by the given start and end indices. * <p> * Indexing is zero based. The range of * a selection is from 0..N where N is * the number of characters in the widget. * </p><p> * Text selections are specified in terms of * caret positions. In a text widget that * contains N characters, there are N+1 caret * positions, ranging from 0..N. This differs * from other functions that address character * position such as getText () that use the * usual array indexing rules. * </p> * * @param start the start of the range * @param end the end of the range * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setSelection (int start, int end) { checkWidget(); /* Clear the highlight before setting the selection. */ int position = OS.XmTextGetLastPosition (handle); // OS.XmTextSetHighlight (handle, 0, position, OS.XmHIGHLIGHT_NORMAL); /* * Bug in MOTIF. XmTextSetSelection () fails to set the * selection when the receiver is not realized. The fix * is to force the receiver to be realized by forcing the * shell to be realized. If the receiver is realized before * the shell, MOTIF fails to draw the text widget and issues * lots of X BadDrawable errors. */ if (!OS.XtIsRealized (handle)) getShell ().realizeWidget (); /* Set the selection. */ int xDisplay = OS.XtDisplay (handle); if (xDisplay == 0) return; start = Math.min (Math.max (start, 0), position); end = Math.min (Math.max (end, 0), position); int nStart = Math.min (start, end), nEnd = Math.max (start, end); boolean warnings = display.getWarnings (); display.setWarnings (false); OS.XmTextSetSelection (handle, nStart, nEnd, OS.XtLastTimestampProcessed (xDisplay)); /* Force the i-beam to follow the highlight/selection. */ if (start > end) { OS.XmTextSetInsertionPosition (handle, nStart); } else { OS.XmTextSetInsertionPosition (handle, nEnd); } display.setWarnings (warnings); } /** * Sets the selection to the range specified * by the given point, where the x coordinate * represents the start index and the y coordinate * represents the end index. * <p> * Indexing is zero based. The range of * a selection is from 0..N where N is * the number of characters in the widget. * </p><p> * Text selections are specified in terms of * caret positions. In a text widget that * contains N characters, there are N+1 caret * positions, ranging from 0..N. This differs * from other functions that address character * position such as getText () that use the * usual array indexing rules. * </p> * * @param selection the point * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the point is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setSelection (Point selection) { checkWidget(); if (selection == null) error (SWT.ERROR_NULL_ARGUMENT); setSelection (selection.x, selection.y); } /** * Sets the number of tabs. * <p> * Tab stop spacing is specified in terms of the * space (' ') character. The width of a single * tab stop is the pixel width of the spaces. * </p> * * @param tabs the number of tabs * * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setTabs (int tabs) { checkWidget(); /* Do nothing. Tabs are not supported in MOTIF. */ } /** * Sets the contents of the receiver to the given string. If the receiver has style * SINGLE and the argument contains multiple lines of text, the result of this * operation is undefined and may vary from platform to platform. * * @param string the new text * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the string is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setText (String string) { checkWidget(); if (string == null) error (SWT.ERROR_NULL_ARGUMENT); byte [] buffer = Converter.wcsToMbcs (getCodePage (), string, true); boolean warnings = display.getWarnings (); display.setWarnings (false); OS.XmTextSetString (handle, buffer); OS.XmTextSetInsertionPosition (handle, 0); display.setWarnings(warnings); } /** * Sets the contents of the receiver to the characters in the array. If the receiver * has style <code>SWT.SINGLE</code> and the argument contains multiple lines of text * then the result of this operation is undefined and may vary between platforms. * * @param text a character array that contains the new text * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the array is null</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see #getTextChars() * * @since 3.7 */ public void setTextChars (char [] text) { checkWidget(); if (text == null) error (SWT.ERROR_NULL_ARGUMENT); byte [] buffer = Converter.wcsToMbcs (getCodePage (), text, true); boolean warnings = display.getWarnings (); display.setWarnings (false); OS.XmTextSetString (handle, buffer); OS.XmTextSetInsertionPosition (handle, 0); display.setWarnings(warnings); } /** * Sets the maximum number of characters that the receiver * is capable of holding to be the argument. * <p> * Instead of trying to set the text limit to zero, consider * creating a read-only text widget. * </p><p> * To reset this value to the default, use <code>setTextLimit(Text.LIMIT)</code>. * Specifying a limit value larger than <code>Text.LIMIT</code> sets the * receiver's limit to <code>Text.LIMIT</code>. * </p> * * @param limit new text limit * * @exception IllegalArgumentException <ul> * <li>ERROR_CANNOT_BE_ZERO - if the limit is zero</li> * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * * @see #LIMIT */ public void setTextLimit (int limit) { checkWidget(); if (limit == 0) error (SWT.ERROR_CANNOT_BE_ZERO); OS.XmTextSetMaxLength (handle, limit); } /** * Sets the zero-relative index of the line which is currently * at the top of the receiver. This index can change when lines * are scrolled or new lines are added and removed. * * @param index the index of the top item * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setTopIndex (int index) { checkWidget(); if ((style & SWT.SINGLE) != 0) return; if (scrolledHandle == 0) return; int [] argList1 = {OS.XmNverticalScrollBar, 0}; OS.XtGetValues (scrolledHandle, argList1, argList1.length / 2); if (argList1 [1] == 0) return; int [] argList2 = {OS.XmNvalue, 0}; OS.XtGetValues (argList1 [1], argList2, argList2.length / 2); OS.XmTextScroll (handle, index - argList2 [1]); } /** * Shows the selection. * <p> * If the selection is already showing * in the receiver, this method simply returns. Otherwise, * lines are scrolled until the selection is visible. * </p> * * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void showSelection () { checkWidget(); boolean warnings = display.getWarnings (); display.setWarnings (false); int position = OS.XmTextGetInsertionPosition (handle); OS.XmTextShowPosition (handle, position); display.setWarnings (warnings); } int traversalCode (int key, XKeyEvent xEvent) { int bits = super.traversalCode (key, xEvent); if ((style & SWT.READ_ONLY) != 0) return bits; if ((style & SWT.MULTI) != 0) { bits &= ~SWT.TRAVERSE_RETURN; if (key == OS.XK_Tab && xEvent != null) { boolean next = (xEvent.state & OS.ShiftMask) == 0; if (next && (xEvent.state & OS.ControlMask) == 0) { bits &= ~(SWT.TRAVERSE_TAB_NEXT | SWT.TRAVERSE_TAB_PREVIOUS); } } } return bits; } int XExposure (int w, int client_data, int call_data, int continue_to_dispatch) { if ((style & SWT.SINGLE) != 0 && message.length () > 0) { if (!hasFocus () && OS.XmTextGetLastPosition (handle) == 0) { /* * Feature in Motif. XmText fills its background during exposure * without respecting the damage clipping. This erases all previous * paints. The fix is always to draw the entire content ignoring * the damage. */ int [] argList = new int [] { OS.XmNmarginWidth, 0, OS.XmNmarginHeight, 0, OS.XmNshadowThickness, 0, OS.XmNhighlightThickness, 0, OS.XmNwidth, 0, OS.XmNheight, 0, }; OS.XtGetValues (handle, argList, argList.length / 2); int marginWidth = argList [1] + argList[5] + argList[7]; int marginHeight = argList [3] + argList[5] + argList[7]; Rectangle rect = new Rectangle (marginWidth, marginHeight, argList [9] - 2 * marginWidth, argList [11] - 2 * marginHeight); GCData data = new GCData (); GC gc = GC.motif_new (this, data); gc.setForeground (disabledColor); gc.setClipping (rect); gc.drawString (message, rect.x, rect.y, true); gc.dispose (); } } return super.XExposure (w, client_data, call_data, continue_to_dispatch); } int xFocusIn (XFocusChangeEvent xEvent) { super.xFocusIn (xEvent); // widget could be disposed at this point if (handle == 0) return 0; if ((style & (SWT.READ_ONLY | SWT.SINGLE)) != 0) { int [] argList = {OS.XmNcursorPositionVisible, 1}; OS.XtSetValues (handle, argList, argList.length / 2); } if ((style & SWT.SEARCH) != 0) { redrawHandle (0, 0, 0, 0, true, handle); } return 0; } int xFocusOut (XFocusChangeEvent xEvent) { super.xFocusOut (xEvent); // widget could be disposed at this point if (handle == 0) return 0; if ((style & (SWT.READ_ONLY | SWT.SINGLE)) != 0) { int [] argList = {OS.XmNcursorPositionVisible, 0}; OS.XtSetValues (handle, argList, argList.length / 2); } if ((style & SWT.SEARCH) != 0) { redrawHandle (0, 0, 0, 0, true, handle); } return 0; } int XmNactivateCallback (int w, int client_data, int call_data) { postEvent (SWT.DefaultSelection); return 0; } int XmNmodifyVerifyCallback (int w, int client_data, int call_data) { int result = super.XmNmodifyVerifyCallback (w, client_data, call_data); if (result != 0) return result; if (echoCharacter == '\0' && !hooks (SWT.Verify) && !filters (SWT.Verify)) return result; XmTextVerifyCallbackStruct textVerify = new XmTextVerifyCallbackStruct (); OS.memmove (textVerify, call_data, XmTextVerifyCallbackStruct.sizeof); XmTextBlockRec textBlock = new XmTextBlockRec (); OS.memmove (textBlock, textVerify.text, XmTextBlockRec.sizeof); byte [] buffer = new byte [textBlock.length]; OS.memmove (buffer, textBlock.ptr, textBlock.length); String codePage = getCodePage (); String text = new String (Converter.mbcsToWcs (codePage, buffer)); String newText = text; if (!ignoreChange) { Event event = new Event (); if (textVerify.event != 0) { XKeyEvent xEvent = new XKeyEvent (); OS.memmove (xEvent, textVerify.event, XKeyEvent.sizeof); event.time = xEvent.time; setKeyState (event, xEvent); } event.start = textVerify.startPos; event.end = textVerify.endPos; event.doit = textVerify.doit == 1; event.text = text; sendEvent (SWT.Verify, event); newText = event.text; textVerify.doit = (byte) ((event.doit && newText != null) ? 1 : 0); } if (newText != null) { if (echoCharacter != '\0' && (textVerify.doit != 0)) { String string = new String (hiddenText); String prefix = string.substring (0, textVerify.startPos); String suffix = string.substring (textVerify.endPos, string.length ()); string = prefix + newText + suffix; hiddenText = new char [string.length()]; string.getChars(0, hiddenText.length, hiddenText, 0); char [] charBuffer = new char [newText.length ()]; for (int i=0; i<charBuffer.length; i++) { charBuffer [i] = echoCharacter; } newText = new String (charBuffer); } if (newText != text) { OS.XtFree(textBlock.ptr); byte [] buffer2 = Converter.wcsToMbcs (codePage, newText, true); int length = buffer2.length; int ptr = OS.XtMalloc (length); OS.memmove (ptr, buffer2, length); textBlock.ptr = ptr; textBlock.length = buffer2.length - 1; OS.memmove (textVerify.text, textBlock, XmTextBlockRec.sizeof); } } OS.memmove (call_data, textVerify, XmTextVerifyCallbackStruct.sizeof); return result; } int XmNvalueChangedCallback (int w, int client_data, int call_data) { if (!ignoreChange) sendEvent (SWT.Modify); return 0; } }